home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / cp201.zip / CATPORT.DOC next >
Text File  |  1992-02-13  |  32KB  |  838 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                         ╒═════════════════════════════╕
  23.                         │    CatPort Version 2.01     │
  24.          ╒══════════════╛                             ╘══════════════╕
  25.          │  Doorfile conversion / control utility for Wildcat! 3.xx  │
  26.          ╘══════════════╕                            ╒═══════════════╛
  27.                         │     (c) 1992 - RhoSoft     │
  28.                         ╘════════════════════════════╛
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                           Table of Contents
  67.  
  68.                           Introduction...................1
  69.                           Why CatPort?...................1
  70.                           Technical description..........2
  71.                           Legal mumbo-jumbo..............3
  72.                           Distribution / Registration....3
  73.                           General operation..............4
  74.                           Command format.................5
  75.                           Enhanced options...............5
  76.                             ASWAP........................5
  77.                             SLIMIT.......................6
  78.                             RESTRICT.....................6
  79.                             TLIMIT.......................6
  80.                             CONFS........................6
  81.                             NODES........................7
  82.                             LOCK.........................7
  83.                             OPEN.........................7
  84.                           Usage samples..................8
  85.                           Notes for enhanced options.....9
  86.                           Error Logging..................10
  87.                           Support........................11
  88.                           Registration form..............12
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.                                                            CatPort 2.00  (i)
  116.  
  117.  
  118.    Introduction
  119.  
  120.         CatPort is a doorfile converter, especially written for Wildcat
  121.      version 3.00 and up. What is a doorfile converter? Simply, it is
  122.      a program that enables a BBS sysop to run a wider selection of online
  123.      programs as external additions to his or her BBS (these programs are
  124.      typically referred to as "doors").
  125.         Each "brand" of BBS software that supports door programs creates
  126.      a file by which it may pass information regarding the on-line caller
  127.      to the door program, such as the caller's name, password, amount of
  128.      logon time left, and color / graphics preferences. These information
  129.      files are typically called door dropfiles.
  130.         The basic problem is that most BBS programs create this dropfile in
  131.      a format unique to themselves. Since there are many BBS packages on the
  132.      market, literally dozens of names/formats of door dropfiles exist, all
  133.      slightly different from each other. When a programmer writes a door
  134.      program, he or she generally cannot take ALL dropfile formats into
  135.      consideration, so the program is written to expect a door dropfile that
  136.      matches a particular format, or perhaps one of a small selection of
  137.      formats. Without a dropfile converter, a door program that was written
  138.      to run on an RBBS-PC BBS cannot run on a Wildcat BBS, since RBBS-PC and
  139.      Wildcat create different dropfile formats. A dropfile converter reads
  140.      the information associated with one particular BBS dropfile format, and
  141.      writes the appropriate dropfile format that the door program expects to
  142.      see. CatPort will read the files produced by Wildcat (these are called
  143.      DOOR.SYS and USERINFO.DAT), and create a selected dropfile format from
  144.      them.
  145.  
  146.    Why CatPort?
  147.  
  148.         In my attempts to run door programs not written for Wildcat, I
  149.      began looking for conversion programs that would read the two files
  150.      Wildcat 3 creates and output an appropriate dropfile. After many
  151.      failures, I found 2 common problems with most, and decided to code my own.
  152.         First, Wildcat 3 uses the brand-new format for DOOR.SYS, arrived at
  153.      in July of 1991, and was the first such BBS to do so. This in effect
  154.      makes the DOOR.SYS that wildcat creates different in amount of
  155.      information from other BBS programs using the same "standard" format.
  156.      All dropfile converters I tried that supported the older format failed
  157.      due to an inability to handle the extra data in Wildcat's DOOR.SYS.
  158.         Second, some programs worked "some of the time" - some users had
  159.      problems, others didn't. I finally managed to trace this to the fact
  160.      that some of the data Wildcat places in the DOOR.SYS may be much longer
  161.      than expected -  something that most other doorfile converters did not
  162.      take into effect. The only product I found that always worked was Steve
  163.      Cox's excellent LIVECAT door environment, but there were some programs
  164.      I wanted to run as DOS hooks, and not include in LIVECAT's menuing
  165.      system. For these, LIVECAT was simply "overkill", and since I place
  166.      time limit restrictions on games in LIVECAT, these restrictions were
  167.      being carried over to non-game programs that I did not want restrictions
  168.      placed upon. This meant I could not use LIVECAT for these programs.
  169.  
  170.  
  171.  
  172.  
  173.                                                            CatPort 2.00  (1)
  174.  
  175.  
  176.  
  177.    Technical description of CatPort
  178.  
  179.         CatPort is written in Borland Turbo C++, which makes it very
  180.      compact and fast. In fact, in most environments, CatPort will perform
  181.      its' duties in about 1 second.
  182.         CatPort version 2.00 provides the ability to create the following
  183.      door dropfiles:
  184.                      CALLINFO.BBS (Used by doors for Wildcat version 2)
  185.                      DORINFO1.DEF (Used by doors for RBBS-PC )
  186.                      CHAIN.TXT    (Used by doors for WWIV (see note) )
  187.                      DOOR.SYS (1) (An older format of DOOR.SYS, adhering
  188.                                    to the "original" DOOR.SYS spec for
  189.                                    the GAP BBS program. If your door that
  190.                                    claims to support DOOR.SYS doesn't like
  191.                                    Wildcat's, try this)
  192.                      PCBOARD.SYS   (Used by doors for PCBoard V14)
  193.                      DOOR.SYS (2)  (The same as Wildcat's DOOR.SYS, with
  194.                                    all data lines shortened to <81 characters.
  195.                                    Mainly used for enhanced options, although
  196.                                    may be useful otherwise)
  197.                      DOOR.SYS  (3) (Special DOOR.SYS used by the DOORWAY pgm)
  198.                      SFDOORS.DAT   (Used by doors for Spitfire)
  199.  
  200.      (Note: WWIV has a very unique way of handling doors, and many doors
  201.             written specifically for WWIV rely upon screen i/o routines that
  202.             are internal to WWIV, as well as a dropfile. Doors such as these
  203.             will not work with just a CHAIN.TXT file, and cannot be made to.
  204.             They require WWIV. Other doors that support multiple dropfile
  205.             formats including CHAIN.TXT usually have no such requirements,
  206.             and will work fine with just the CHAIN.TXT that CatPort creates.)
  207.  
  208.         CatPort includes a number of special enhanced options (in the
  209.      registered version), which enable the Wildcat sysop to custom-tailor
  210.      the data written to the dropfile. These will be explained in detail
  211.      later.
  212.  
  213.         Dropfiles created by CatPort have less hard-coded information than
  214.      other BBS doorfile converters, and with very few exceptions have NO
  215.      blank lines in them. Whenever Wildcat provides the data a dropfile needs,
  216.      CatPort uses it, no matter how obscure. This ensures that dropfiles
  217.      created by CatPort will work sucessfully as input to nearly every OTHER
  218.      doorfile converter, should a format other than one of the internally-
  219.      support CatPort formats be required. Of course, it is our wish to add all
  220.      typically required formats to CatPort internally, and we actively solicit
  221.      submissions of doorfile format structures from door authors or users of
  222.      CatPort. However, should a sysop need to create a format that CatPort
  223.      does not create itself, they may use any of CatPort's supported output
  224.      formats with another doorfile converter to arrive at the desired result
  225.      (including doorfile converters that do not work with Wildcat 3!). We
  226.      recommend using the CALLINFO.BBS file if it needs to be fed to another
  227.      conversion program, as it contains the most complete caller data of the
  228.      formats CatPort presently creates.
  229.  
  230.  
  231.  
  232.                                                            CatPort 2.00  (2)
  233.  
  234.  
  235.  
  236.    Legal mumbo-jumbo
  237.  
  238.         CatPort is guaranteed to do only one thing: take up space on
  239.      your disk or diskette. While CatPort has been extensively tested under
  240.      many environments without mishap, the author and RhoSoft can not
  241.      accept any responsibility or liability for ANY damage to data and/or
  242.      equipment that may result from the use of CatPort. By running the program,
  243.      the user releases RhoSoft and the author(s) of CatPort from all
  244.      potential liability and/or claims as a result of CatPort's use.
  245.  
  246.    Registration / Distribution
  247.  
  248.         CatPort is marketed as SHAREWARE. This means that you are encouraged
  249.      to evaluate CatPort for a period of 30 days, after which time you must
  250.      either register the product or discontinue its' use. Registration of
  251.      CatPort is NOT expensive. CatPort version 2.00 costs 15 dollars (US).
  252.      Registered users of CatPort are entitled to free program upgrades over
  253.      the life of the product, so registering early assures the most for your
  254.      money.
  255.         Registration of CatPort provides you with a personal registration
  256.      id which will "unlock" the enhanced features of the product. In its'
  257.      unregistered form, CatPort will read/write dropfiles only. All options
  258.      to manipulate data are considered enhanced features. Registered users
  259.      may receive support from the RhoSoft staff, as well as provide input
  260.      on new features for future releases.
  261.  
  262.         You are encouraged to distribute copies of CatPort in the original
  263.      unaltered archive. You may not, however, distribute registration ids.
  264.      The latest version of CatPort is available for network file request
  265.      from the support BBS, as well as for download on the Mustang HQ BBS.
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.                                                            CatPort 2.00  (3)
  292.  
  293.  
  294.  
  295.    General Operation
  296.  
  297.         CatPort is executed from the node home directory (for multi-node
  298.      systems), or from the work directory for a single-line system. This is,
  299.      by default, the current directory when Wildcat executes a door or menu
  300.      hook batch file. CatPort requires the following four files to be present
  301.      for operation:
  302.                      CATPORT.EXE  (Can be anywhere in the DOS path)
  303.                      CATPORT.CFG  (Can be anywhere in the DOS path)
  304.                      DOOR.SYS     (Created by WC in the node/work directory)
  305.                      USERINFO.DAT (Created by WC in the node/work directory)
  306.  
  307.      If any of the last three files are missing, Catport will cease operation.
  308.  
  309.         CATPORT.CFG:
  310.  
  311.         CatPort requires the presence of a file called CATPORT.CFG, which
  312.      must be locally created, and must exist somewhere in the DOS path for
  313.      the system CatPort is running on. A sample CFG file, called CATPORT.SMP,
  314.      is provided with the distribution archive. Its' format is as follows:
  315.  
  316. line 1: BBS Name
  317. Line 2: Sysop's first name
  318. Line 3: Sysop's last name
  319. Line 4: CatPort registration id
  320. -------------------------------- (lines below line 4 are ignored)
  321.  
  322.         All information must be provided, as some door dropfiles require
  323.      the sysop's name or BBS name. If CatPort determines the registration
  324.      id to be invalid, the enhanced options will be disabled, so any info
  325.      can be entered in this field prior to registering CatPort.
  326.  
  327.         CatPort controls execution via DOS errorlevels, so your BAT file
  328.      will need to check for these errorlevels. CatPort errorlevels are:
  329.  
  330.      Errorlevel 255  = File missing, read/write error, internal CatPort error.
  331.      Errorlevel 100  = Caller rejected due to OPEN setting
  332.      Errorlevel  90  = Caller rejected due to LOCK setting
  333.      Errorlevel  80  = Caller rejected due to NODES setting
  334.      Errorlevel  70  = Caller rejected due to CONFS setting
  335.      Errorlevel  60  = Caller rejected due to RESTRICT setting.
  336.      Errorlevel  50  = Caller rejected due to SLIMIT setting.
  337.      Errorlevel  40  = ASWAP specified, but no alias exists for caller.
  338.  
  339.      An errorlevel below 40 means CatPort wrote the requested dropfile,
  340.      making modifications as requested by enhanced options. These are:
  341.  
  342.      Errorlevel   7  = SFDOORS.DAT Created sucessfully.
  343.      Errorlevel   6  = DOOR.SYS (Doorway) Created sucessfully.
  344.      Errorlevel   5  = DOOR.SYS (Wildcat) Created sucessfully.
  345.      Errorlevel   4  = PCBOARD.SYS Created sucessfully.
  346.      Errorlevel   3  = DOOR.SYS (Old version) Created sucessfully.
  347.      Errorlevel   2  = CHAIN.TXT Created sucessfully.
  348.      Errorlevel   1  = DORINFO1.DEF Created sucessfully.
  349.      Errorlevel   0  = CALLINFO.BBS Created sucessfully.
  350.  
  351.  
  352.  
  353.                                                            CatPort 2.00  (4)
  354.  
  355.  
  356.  
  357.    Command format
  358.  
  359.         All CatPort functions are specified as command-line parameters.
  360.      The basic command line format to invoke CatPort is as follows:
  361.  
  362.      Catport x d:\path\ option1 option2 etc
  363.  
  364.      In the above example,
  365.              x = The identifier for the dropfile format required
  366.                      0 = CALLINFO.BBS
  367.                      1 = DORINFO1.DEF
  368.                      2 = CHAIN.TXT
  369.                      3 = DOOR.SYS (Old)
  370.                      4 = PCBOARD.SYS
  371.                      5 = DOOR.SYS (WC)
  372.                      6 = DOOR.SYS (Doorway)
  373.                      7 = SFDOORS.DAT
  374.  
  375.                  Any number greater than 6 , or any other non-valid
  376.                  identifier results in an abnormal exit with errorlevel 255.
  377.  
  378.       d:\path\ = The COMPLETE drive/path (WITH TRAILING BACKSLASH) where the
  379.                  selected door dropfile is to be written. For example,
  380.                  e:\bbs\doors\yt\ would be a valid parameter. NOTE! Failure to
  381.                  include the trailing backslash will result in the selected
  382.                  dropfile being improperly named, or being written to the wrong
  383.                  subdirectory. YOU SHOULD NOT SPECIFY THE DROPFILE NAME ON
  384.                  THIS PARAMETER.
  385.  
  386.       option1  = Enhanced options you wish to use. These may be in any order,
  387.       option2    and multiple options may be specified.
  388.       etc
  389.  
  390.    Enhanced options (available in registered versions only)
  391.  
  392.      ASWAP
  393.  
  394.         Catport allows you to write the door dropfile using the callers'
  395.      alias rather than their real name. This allows the sysop to make a door
  396.      program "anonymous" by nature, especially if the door does not allow for
  397.      handles or nicknames to be selected internally. If the caller does not
  398.      have an alias established, CatPort will exit with an errorlevel of 40,
  399.      AND WILL NOT WRITE THE DOOR DROPFILE. The controlling door .BAT file
  400.      may then exit based upon this errorlevel.
  401.        Note to users of DORINFO1.DEF: The defined standard for DORINFO1.DEF is
  402.      based upon a "First name, Last name" methodology. Therefore, aliases
  403.      using less than 2 words will result in a BLANK last name, and aliases
  404.      using more than 2 words will result in a TRUNCATED name (IE, a caller
  405.      with an alias of "The Lone Ranger" will appear in DORINFO1.DEF as
  406.      simply "firstname = THE, lastname = LONE".
  407.  
  408.  
  409.  
  410.  
  411.  
  412.                                                            CatPort 2.00  (5)
  413.  
  414.  
  415.  
  416.  
  417.      SLIMIT xxxx
  418.  
  419.         You may instruct CatPort to only permit a caller access to a door
  420.      if their security level is higher than (or equal to) the one specified
  421.      following the SLIMIT keyword (xxxx). If a caller with a security
  422.      level below the SLIMIT value attempts to run use the door, CatPort will
  423.      exit with an errorlevel of 50 AND WILL NOT WRITE THE DOOR DROPFILE.
  424.      The controlling door .BAT file may then exit based upon this errorlevel.
  425.      SLIMT expects a following keyword value of from 1-9999.
  426.  
  427.      RESTRICT xxxx
  428.  
  429.         RESTRICT is very similar to SLIMIT, except that it only permits a
  430.      caller to access the door if their security level is EQUAL to the one
  431.      specified following the RESTRICT keyword (xxxx). If the callers' security
  432.      level does not match, CatPort will exit with an errorlevel of 60 AND WILL
  433.      NOT WRITE THE DOOR DROPFILE. The controlling door .BAT file may then exit
  434.      based upon this errorlevel. RESTRICT expects a following keyword value of
  435.      from 1-9999.
  436.  
  437.      TLIMIT xxx
  438.  
  439.         You may instruct CatPort to allow a maximum period of time in a door
  440.      for a caller by using the TLIMIT function. TLIMIT expects a following
  441.      keyword equal to the maximum time allowed for the door being run. If the
  442.      callers' logon time for the day is more than the TLIMIT value, the output
  443.      door dropfile will be written showing the user with the value of TLIMIT
  444.      as time remaining for the day. IN NO CASE WILL USING TLIMIT ALTER THE
  445.      CALLERS ACTUAL LOGON TIME REMAINING FOR THE BBS. If the caller has less
  446.      logon time left than the limit specified, the actual logon time left will
  447.      be written to the door dropfile. USING TLIMIT WILL NEVER INCREASE THE
  448.      AMOUNT OF LOGON TIME A CALLER HAS. Note that TLIMIT implies a "per play"
  449.      time restriction, and not a "per day" limit. A caller can conceivably
  450.      re-run the door after their TLIMIT time has expired, providing they have
  451.      adequate logon time remaining on the BBS.
  452.  
  453.      CONFS xxx yyy zzz
  454.  
  455.         You may instruct CatPort to only permit the execution of the door
  456.      when the user has entered the door from a specific conference number.
  457.      Following the CONFS keyword is a list of space-delineated conference
  458.      numbers which are acceptable. (ie, CONFS 1 10 100). If the caller
  459.      entered the door from a conference other than the ones listed, errorlevel
  460.      70 will be returned, and the dropfile will NOT be written.
  461.      Note: There is no arbitrary limit on the number of parameters after
  462.      the CONFS keyword.. it simply must be at least 1 value (ie,
  463.      CONFS 1 is valid, as is CONFS 1 5 3 2 10 44 33. Numbers need not be
  464.      in ascending or descending order).
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.                                                            CatPort 2.00  (6)
  473.  
  474.  
  475.  
  476.      NODES x y z
  477.  
  478.         You may instruct CatPort to only permit the execution of the door
  479.      from certain nodes. This allows a sysop to reserve certain nodes for
  480.      strictly message/file traffic, for example. The format is identical
  481.      to the CONFS option - the nodes permissable to execute the door follow
  482.      the NODES command (ie, NODES 1 2 4). If run from a node NOT permitted,
  483.      errorlevel 80 will be returned, and the dropfile will NOT be written.
  484.      Note: There is no arbitrary limit on the number of parameters after
  485.      the NODES keyword.. it simply must be at least 1 value (ie,
  486.      NODES 1 is valid, as is NODES 1 5 3 2 10 44 33. Numbers need not be
  487.      in ascending or descending order).
  488.  
  489.      LOCK
  490.  
  491.         Every BBS has a couple callers that a sysop wishes (s)he could keep
  492.      out of certain door programs for various reasons. This option enables
  493.      that. By specifying LOCK on the command line, CatPort will search the DOS
  494.      path for a file called LOCKDOOR.x (x = the door number being run), and
  495.      will read that file, matching user names listed in the file against the
  496.      caller. If found, errorlevel 90 will be returned, and the dropfile will
  497.      NOT be written.
  498.  
  499.      OPEN
  500.  
  501.         OPEN is basically the reverse of LOCK. When OPEN is used, the sysop
  502.      wants to restrict door use to a certain few users, as opposed to barring
  503.      a certain few as LOCK permits. When specified, CatPort will search the DOS
  504.      path for a file called OPENDOOR.x (x = the door number being run), and
  505.      will read that file, matching user names listed in the file against the
  506.      caller. If not found, errorlevel 100 will be returned, and the dropfile
  507.      will NOT be written.
  508.  
  509.  
  510.      Note for the OPEN and LOCK functions:
  511.         OPEN and LOCK functions ALWAYS key off the name under which the user
  512.      logs onto the system. Even if the ASWAP function is called prior to
  513.      LOCK or OPEN, the check is performed on the callers' real name.
  514.  
  515.  
  516.      Sequence of Enhance option execution:
  517.  
  518.         Regardless of the order specified on the command line, enhanced
  519.      options always execute in the following order:
  520.  
  521.      1) ASWAP
  522.      2) TLIMIT
  523.      3) SLIMIT
  524.      4) RESTRICT
  525.      5) CONFS
  526.      6) NODES
  527.      7) LOCK
  528.      8) OPEN
  529.  
  530.      All options may be combined as desired.
  531.                                                            CatPort 2.00  (7)
  532.  
  533.  
  534.  
  535.    Usage Samples
  536.  
  537.         The following samples give an idea of how you would execute CatPort
  538.      in a door .BAT file:
  539.  
  540.      Case 1: Create callinfo.bbs, in directory c:\bbs\yt\.
  541.  
  542.              CatPort 0 c:\bbs\yt\
  543.  
  544.      Case 2: Create Chain.txt, in directory F:\bbs\wwiv\, forcing alias use.
  545.  
  546.              CatPort 2 f:\bbs\wwiv\ ASWAP
  547.  
  548.      Case 3: Create Door.sys (old) in directory e:\game\, forcing time limit.
  549.  
  550.              CatPort 3 e:\game\ TLIMIT 30
  551.  
  552.      Case 4: Create Pcboard.sys in directory c:\wc30\door3\, restrict access
  553.              to only users meeting security level 100, and only those
  554.              listed in the OPENDOOR.3 file (assuming this is door #3)
  555.  
  556.              CatPort 4 c:\wc30\door3\ RESTRICT 100 OPEN
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.      Note: Enhanced options may be combined, but are ignored in unregistered
  565.      versions of CatPort.
  566.  
  567.      Note for users of CatPort V1.00:
  568.  
  569.         CatPort no longer creates a GAPDOOR.SYS file, and any batch files
  570.      which performed a rename of GAPDOOR.SYS to DOOR.SYS must be updated
  571.      to remove the rename step. This change, while requested by many
  572.      CatPort sysops, raises a cause for caution. It is entirly possible now
  573.      for you to inadvertantly overwrite the Wildcat-created DOOR.SYS file
  574.      with a version of DOOR.SYS CatPort has created (CatPort offers 3
  575.      variations of DOOR.SYS). While this SHOULDN'T harm anything (Wildcat
  576.      at present DOES NOT read back info from DOOR.SYS upon return from a door),
  577.      caution should be excercised in determining the output directory for
  578.      the dropfile CatPort creates.
  579.  
  580.  
  581.                                                            CatPort 2.00  (8)
  582.  
  583.  
  584.      Notes for users of enhanced options:
  585.  
  586.      .BAT files
  587.  
  588.         In order to make your users aware of CatPort - caused rejections, your
  589.      door BAT files should be aware of the rejection errorlevels. This sample
  590.      DOOR.BAT file assumes that the caller is on COM1, and uses both SLIMIT
  591.      and RESTRICT options in the CatPort call. While this is technically
  592.      possible, it is redundant, and in practice you will never need to specify
  593.      both options.
  594.  
  595.      @echo off
  596.      CatPort 1 c:\wc30\door\yt\ ASWAP SLIMIT 100 RESTRICT 200
  597.      If errorlevel 255 goto fail
  598.      If errorlevel  60 goto R_reject
  599.      If errorlevel  50 goto S_reject
  600.      If errorlevel  40 goto A_reject
  601.      cd \wc30\door\yt
  602.      yt
  603.      goto end
  604.      :fail
  605.      Echo An error has occurred. Please notify sysop! > COM1:
  606.      goto end
  607.      :R_reject
  608.      Echo Your security level does not match required level for door. > COM1:
  609.      goto end
  610.      :S_reject
  611.      Echo Your security level is not high enough for this door. > COM1:
  612.      goto end
  613.      :A_reject
  614.      Echo You do not have an alias defined, and can not use this door. > COM1:
  615.      goto end
  616.      :end
  617.      cd \wc30
  618.  
  619.    Usage note: Since Catport always deletes a previously-existing
  620.                version of the requested dropfile (if found), it is not
  621.                ABSOLUTELY necessary to match errorlevels, as the door
  622.                program itself will "bomb out" and fail to run when it
  623.                does not find a proper dropfile to read. Doing things this
  624.                way, though, will leave your caller in the dark as to why
  625.                the door failed to run.
  626.  
  627.      OPEN and LOCK option file requirements
  628.  
  629.         When using the OPEN and LOCK commands, CatPort expects to find a
  630.      file somewhere in the DOS path which contains the names of callers allowed
  631.      to use the door (for OPEN), or the names of callers barred from the door
  632.      (for LOCK). These filenames are called are OPENDOOR.x and LOCKDOOR.x
  633.      (in both cases, x refers to the number of the door that these files
  634.      oertain to). These files are not required for use, and CatPort will
  635.      function if they are missing. If the appropriate OPENDOOR.x file is
  636.      missing, it will be assumed NOBODY is allowed to use the door (perhaps
  637.      not too useful!), if the OPEN option is specified on the command line.
  638.      If LOCKDOOR.x is missing and LOCK has been specified on the command line,
  639.      it is assumed nobody has been barred access to the door.
  640.  
  641.                                                            CatPort 2.00  (9)
  642.  
  643.  
  644.         A sample OPENDOOR and LOCKDOOR file have provided in the distribution
  645.      archive, by the name of OPENDOOR.SMP and LOCKDOOR.SMP. These are simple
  646.      flat-file ASCII files, with one full name (first and last) per line.
  647.  
  648.         Sample OPENDOOR.1 (this would be a permission list for door #1)
  649.  
  650.      JOHN SMITH
  651.      JANE DOE
  652.  
  653.        (LOCKDOOR.1 would follow the same pattern.)
  654.  
  655.      Note that if for some reason you specify OPEN and LOCK on the command
  656.      line for CatPort, LOCK will ALWAYS be processed first, therefore, if
  657.      the same name is in both the OPENDOOR and LOCKDOOR files, that user
  658.      will NEVER be permitted access to the door.
  659.  
  660.  
  661.    Error logging
  662.  
  663.         CatPort will write an error log each time the program fails for some
  664.      reason, called CATPORT.LOG, in the same directory CatPort is run from.
  665.      Each error entry is date/time logged. This file should be checked
  666.      occasionally and "pruned" as needed to prevent it from growing too large.
  667.      A seperate CATPORT.LOG will exist in the node work directory of each
  668.      node on a multi-node system. If CatPort generates an errorlevel exit,
  669.      or a user is rejected due to an enhance option limitation, it will be
  670.      logged here. If CatPort cannot create/update the log file, processing
  671.      will continue without error logging.
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.                                                            CatPort 2.00  (10)
  701.  
  702.  
  703.    Support for CatPort:
  704.  
  705.         CatPort is supported for registered users on the Walden Puddle BBS
  706.      at (607) 687-6193/6049, and also via netmail to RhoSoft at 1:260/450
  707.      via FIDOnet, 26:1607/100 via Signet, or 100:910/0 at Magnet. Mail
  708.      from unregistered users is also welcome, although guarantees of speedy
  709.      replies can not be made. We DO, however, take our products seriously,
  710.      and will act promptly on all major bug reports, no matter how reported
  711.      or by whom. Implementation of suggestions for improvment from registered
  712.      users will take precedence over unregistered users.
  713.  
  714.         We also maintain a presence on the Mustang Software HQ BBS, thanks
  715.      to Kevin Brokaw, sysop of the Walden Puddle BBS. Please address mail
  716.      regarding CatPort to him when using the Mustang HQ BBS. Also, we
  717.      follow the international WILDCAT echo in FIDOnet, as well as the
  718.      M-WILDCAT echo in Magnet.
  719.  
  720.  
  721.      What's coming???
  722.         We try to include features and options that are of value to our
  723.      sysops, and are always looking to improve the product. Options under
  724.      development at present are a serial i/o interface for direct
  725.      communication with the user, as well as additional dropfile options.
  726.      Please let us know if you want to see something "special" in CatPort!
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.                                                            CatPort 2.00  (11)
  756.  
  757.  
  758.                      REGISTRATION PROCESS FOR CatPort
  759.  
  760.        Please complete the registration form to register CatPort V2. This
  761.     will entitle you to free program updates for the life of the Product.
  762.     Updates to the product may be downloaded from the Walden Puddle BBS,
  763.     Mustang HQ BBS, or file-requested from the network addresses listed in
  764.     this DOC file under "Support" by the "Magic" name CATPORT.
  765.        You will have a userid created for you on the Walden Puddle BBS, using
  766.     a password you provide. Your CatPort ID will be mailed to you upon
  767.     clearance of your check, or immediately upon receipt of a money order.
  768.     It will also be posted in a private message on the Walden Puddle BBS
  769.     on the same day, if you should wish to obtain it in that manner.
  770.     The latest (or next) version of CatPort can be mailed to you on
  771.     diskette for an additional charge. Please see order info.
  772.  
  773.  
  774.                  Please complete, print, and mail the next page,
  775.                  along with the proper amount in US funds
  776.                  (check or money order, please.. not responsible for
  777.                  cash sent in the mail!) to:
  778.  
  779.                              RhoSoft
  780.                              1026 Day Hollow Rd
  781.                              Owego, NY 13827
  782.                              USA
  783.  
  784.  
  785.  -----------------------------------------------------------------------------
  786.             CatPort Registration - please print, complete, and mail
  787.  
  788.       NOTE! This registration form is valid until 06/1/92. While
  789.             new versions of CatPort may be released prior to that date,
  790.             all registrations received through 6/15/91 for CatPort V2
  791.             will be honored.
  792.  
  793.               Mail to:   RhoSoft
  794.                          1026 Day Hollow Rd
  795.                          Owego, NY 13827 USA
  796.  
  797.  Registering Sysops's Name ______________________________________________
  798.                            (Will be used to set up account on support BBS)
  799.  Password requested        ______________________________________________
  800.                            (Will be used to set up account on support BBS)
  801.  
  802.  
  803.  Registering Sysops's Address ___________________________________________
  804.  
  805.                               ___________________________________________
  806.  
  807.                               ___________________________________________
  808.  
  809.  
  810.   BBS CatPort is registered to __________________________________________
  811.                               (Note: Must EXACTLY match BBS name as you put
  812.                                      it in Catport.cfg - INCLUDING upper/lower
  813.                                      case letters)
  814.  
  815.   Wildcat Registration # __________________________________
  816.  
  817.  
  818.  
  819.   CatPort version you posess (can be found by issuing CATPORT ?)    _________
  820.  
  821.  
  822.  
  823.  
  824.                                 CatPort 2.00 Registration          __$ 15.00__
  825.  
  826.  
  827.                                 Latest/Next CatPort on Disk
  828.                                   Add 2.50 for 5.25 inch
  829.                                       3.00 for 3.5 inch            ___________
  830.                                       (U.S. users only)
  831.  
  832.  
  833.                                 Total amount enclosed              ___________
  834.                                 (In Check or Money order,
  835.                                  Payable to RhoSoft,
  836.                                  in U.S. Funds)
  837.  
  838.